Disables the icon associated with a menu item.

void DisableMenuItemIcon (
    MenuHandle theMenu, 
    UInt16 item
);

theMenu

A handle to the menu containing the icon to be disabled.

item

The item number of the menu item containing the icon.

DISCUSSION

Your application can use the DisableMenuItemIcon function to dim individual menu item icons. The menu item that contains the icon is unaffected by calling DisableMenuItemIcon. That is, if DisableMenuItemIcon disables an enabled menu item’s icon, the menu item itself will remain enabled. Calling DisableMenuItemIcon on the icon of a menu item that is currently disabled will cause the icon to be disabled once the menu item is re-enabled.

See also the functions EnableMenuItemIcon and IsMenuItemIconEnabled.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when MenusLib 8.5 or later is installed. Exported by CarbonLib 1.0 and later and by MenusLib 8.5 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)